全部文档

子设备数据交互

子设备上传数据

属性

请求topic: $sys/{gpid}/{gdid}/{pid}/{did}/thing/sub/property/post

{
  "version": "1.0",
    "deviceID": "deviceId",
      "params": {
      "key": {
        "time": 1524448722123,
        "value": 12
      }
    }
}

表 . 参数说明

参数 类型 说明
version String 物模型版本号,可选字段,不填默认为1.0
time int 时间戳,毫秒
key String 属性名
value object 属性值
params object
deviceID String 子设备id

响应topic:$sys/{gpid}/{gdid}/{pid}/{did}/thing/sub/property/post/reply

{
"code":200,
"msg":"msg"
}

表 . 响应参数说明

参数 类型 说明
code int 错误码, 200表示成功
msg string 错误信息

事件

设备上报事件topic: $sys/{gpid}/{gdid}/{pid}/{did}/thing/event/post

{
    "id": "123", 
    "version": "1.0", 
    "params": {
        "identifier1": {
            "value": {
                "Power": "on", 
                "WF": "2"
            }, 
            "time": 1524448722123
        }, 
        "identifier2": {
            "value": {
                "Power": "on", 
                "WF": "2"
            }, 
            "time": 1524448722123
        }
    }
}

表 . 参数说明

参数 类型 说明
id string 消息id号,用户自定义,String类型的数字,长度限制不超过13位。暂未使用, 可选
version String 物模型版本号,可选字段,不填默认为1.0
time int 时间戳, 毫秒
key String 属性名
params object
identifier String 事件名
value object 输出参数键值对

子设备命令下发

命令下发: $sys/{gpid}/{gdid}/{pid}/{did}/thing/sub/cmd

  {
    "id": "123",
    "productId": 123,
    "deviceId": 123,
    "functionType": "propertySet",
    "params": {
      "switch": "on"
    },
    "timeout": 10
  }

表 . 参数说明

参数 类型 说明
id string 命令id
productId int 产品id
deviceId int 设备id
functionType String 命令类型, propertySet
params object params为map[string]interface{},key为属性名,value为属性值
timeout int 用户自定义超时时间

命令下发响应:$sys/{gpid}/{gdid}/{pid}/{did}/thing/sub/cmd/reply

  {
    "id": "123",
    "code":0,
    "msg":"msg"
  }

表 . 响应参数说明

参数 类型 说明
id string 命令id
code int 错误码, 0表示成功
msg string 错误信息

子设备服务调用

设备订阅topic: $sys/{gpid}/{gdid}/{pid}/{did}/thing/service 下发结构

  {
    "id": "123",
    "productId": 123,
    "deviceId": 123,
    "params": {
      "switch": "on"
    }
  }

表 . 参数说明

参数 类型 说明
id string 服务id
productId int 产品id
deviceId int 设备id
params object params为map[string]interface{},key为输入参数名,value为输入参数值

服务响应: $sys/{gpid}/{gdid}/{pid}/{did}/thing/service/reply

  {
    "id": "105917531",
    "code": 0,
    "data": {
      "CollectTime": "1536228947682",   // 输出参数
      "OldWeight": 100.101   //输出参数
    }
  }

表 . 响应参数说明

参数 类型 说明
id string 服务id
code int 错误码, 0表示成功
msg Object 返回的结果信息。data参数的值和物模型定义相关。如果服务没有返回结果,则data的值为空。如果服务有返回结果,则返回的数据会严格遵循服务的定义。

results matching ""

    No results matching ""